-- card: 3823 from stack: in
-- bmap block id: 4149
-- flags: 4000
-- background id: 2562
-- name: Columnizerª XCMD Help


-- part 1 (field)
-- low flags: 01
-- high flags: 2007
-- rect: left=75 top=138 right=285 bottom=407
-- title width / last selected line: 0
-- icon id / first selected line: 0 / 0
-- text alignment: 0
-- font id: 3
-- text size: 9
-- style flags: 256
-- line height: 11
-- part name: 


-- part contents for background part 5
----- text -----
Columnizerâ„¢ XCMD Help

-- part contents for card part 1
----- text -----
COLUMNIZER is a FREEWARE XCMD and stack brought to you by COM~LINK.  If you use it in your own stacks, please include the following line somewhere in your 
'About' or 'Credits' card.  Thank you.

    "COLUMNIZER XCMD by S.Koren/COM~LINK"


COLUMNIZER is an XCMD which allows you to easily set up text in columns on a line by line basis.  Among the things which COLUMNIZER is capable of doing are:

  -- Specify a starting column for text
  -- Specify columns at word breaks
  -- Specify columns at delimited fields (delimited by       
       '\')
  -- Specify column separation
  -- Return a character at a given column within a line.
  -- Return a word at a given column
  -- Return a delimited field.


COLUMNIZER SYNTAX:

Columnize <mode>,<start col>,<submode>,<field>
 
<mode> = 0 or 1 or 2
              0 - Columnize
              1 - Extract
              2 - Columnize Fields

when <mode> = 0 or 2:

<start col> = the column where the first column will occur.

<submode> = the number of columns between 'text' columns. (The number of columns between the start of field 'a' and the start of field 'b'.)

<field>  = a line of text to be put into columns.

NOTE:  when <mode> = 2 the delimiting '\' are removed in the final columnized field.

when <mode> = 1:

<start col> = the column to start extraction from.

<submode> = 0 or 1 or 2
    0 - extract character
    1 - extract word
    2 - extract field

   when submode = 1:
      Extraction will extract all characters from <start col> to the next space.

   when submode = 2:
      Extraction will extract all characters from <start col> to the next '\' delimiter.  NOTE:  this submode requires a copy of the original 'uncolumnized' line to work.



Play with the previous card using different values and observe the results.